home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / APW.ORCA.Cmds / Gregs.APW.Utils / Documentation / Choose < prev    next >
Encoding:
Text File  |  1990-07-19  |  6.6 KB  |  144 lines  |  [TEXT/pdos]
  1. Choose -- choose network file server
  2.  
  3. Syntax      Choose [options...] name...
  4.  
  5. Description Choose non-interactively mounts the specified AppleShare volumes.
  6.             Each name takes the form:
  7.  
  8.             [zone]:server:volume
  9.  
  10.             The zone name is always optional and defaults to the current zone.
  11.             A server name must be preceeded by (at least) a colon.  The volume
  12.             name must be separated from the server name by a colon.  Note that
  13.             with the zone name omitted, the server/volume name combination
  14.             appears much like a GS/OS pathname.
  15.  
  16.             When mounting file server volumes, both the server name and volume
  17.             name are required.  If any portion of the zone/server/volume name
  18.             contains a space or semi-colon character, the entire entity name
  19.             must be quoted (to prevent the APW shell from getting confused).
  20.  
  21.             Server and volume passwords are case-sensitive.  More than one
  22.             server and volume may be mounted with a single command, but the
  23.             server and volume passwords must be the same for each, since at
  24.             most one password of each type may be specified on the command
  25.             line.
  26.  
  27.             Instead of specifying the entity name on the command line, you may
  28.             use the -f option to specify a filename of a file in which the
  29.             necessary information has been stored.  You may also use the -w
  30.             option to open an interactive window to specify the necessary
  31.             parameters and (optionally) store them into a file which may be
  32.             used with the -f option.  See the discussion of these options
  33.             below.
  34.  
  35. Input       None.
  36.  
  37. Output      None.
  38.  
  39. Diagnostics Errors are written to diagnostic output.
  40.  
  41.             Various confusing messages (such as "No AFPLogin call has been
  42.             successfully made for this session") are usually the result of a
  43.             missing or mis-types password.
  44.  
  45. Status      The following status codes may be returned:
  46.  
  47.             0   No errors
  48.             1   Syntax error on command line
  49.             2   System error (such as Out Of Memory)
  50.             -1  Abort (Command-.)
  51.  
  52. Options     -f[ile] filename
  53.                 Specify the name of a file that contains the necessary server
  54.                 mount parameters.  (A file may be produced while in the
  55.                 interactive window; see the -w option.)  The filename may
  56.                 contain APW wildcard characters.
  57.  
  58.                 The -f option can not be used when an entity name is specified
  59.                 on the APW command line
  60.  
  61.             -guest
  62.                 Log in as a guest instead of with a user name.
  63.  
  64.             -p[rogress]
  65.                 Display program copyright and progress information during
  66.                 execution.
  67.  
  68.             -pw password
  69.                 Specify the server log-in password.  The server password
  70.                 defaults to the value of the shell variabls "{ServerPassword}".
  71.  
  72.             -u[ser] name
  73.                 Specify the user name for the server log-in.  This option has
  74.                 precedence over the shell variable "{User}", but not over any
  75.                 user name saved in a Choose document file.  If no valid user
  76.                 name is found, -guest is assumed.
  77.  
  78.             -vp password
  79.                 Specify the volume log-in password.  The volume password
  80.                 defaults to the value of the shell variable "{VolumePassword}".
  81.  
  82.             -w[indow]
  83.                 Open an interactive, desktop-style window to be used to enter
  84.                 the necessary log-in information.  This will initialize the
  85.                 full desktop environment so that the Control Panel NDA can be
  86.                 used to "point & click" your way to the server volume, and then
  87.                 enter the information into the fields within the window.  Once
  88.                 the information is set, you can click on the "Mount" button to
  89.                 mount the file server, and/or the "Save" button to save the
  90.                 information in a file which can then be used with the -f
  91.                 option.
  92.  
  93.                 If -w is specified on the command line with no -f option and no
  94.                 entity names, the window will be opened immediately for your
  95.                 use.  If a -f filename or entity name is specified, the window
  96.                 will only be opened if the server log-in fails for some reason.
  97.  
  98.                 Once into the window environment, simply type the requested
  99.                 information into the various fields in the window.  Once this
  100.                 is complete, click on the "Mount" button or press the RETURN
  101.                 key to perform the server log-in.  Click on the "Save" button
  102.                 or press Command-S to save the log-in information into a file.
  103.                 During this process, various messages will appear within the
  104.                 top portion of the window letting you know how things are
  105.                 going.
  106.  
  107.                 This window environment can be used for more than just mounting
  108.                 file servers.  For example, if you needed to get to the Control
  109.                 Panel to select your current printer device, you could use a
  110.  
  111.                     Choose -w
  112.  
  113.                 command to simply open up the desktop environment, which will
  114.                 give you access to the NDA menu (which is where the Control
  115.                 Panel NDA "lives").
  116.  
  117. Examples        Choose :Fern's.World:Pasta
  118.  
  119.                 Mounts the volume :Pasta: on the server Fern's.World located in
  120.                 the current zone, using the default user name, server password,
  121.                 and volume password.
  122.  
  123.  
  124.                 Choose "Development Tools:DSG Server:Almost APW:" -guest
  125.  
  126.                 Mounts the volume :Almost APW: on the server DSG Server in the
  127.                 Development Tools zone as a guest.
  128.  
  129.                 Choose -w -f Green.Public
  130.  
  131.                 Mounts the network entity specified in the file Green.Public,
  132.                 with the user name, server password, and volume password also
  133.                 specified in the file.  If there is any problem in performing
  134.                 the log-in, the interactive window will be opened with the
  135.                 fields initialized to the values contained within the file.
  136.                 This will allow you to modify the field values and try the
  137.                 log-in again, then save the modified parameters back into the
  138.                 file. (This is useful when the zone of a particular entity has
  139.                 changed.)
  140.  
  141.  
  142. See Also        Eject, which can be used to UnMount server volumes, and
  143.                 Online, which can be used to list currently mounted volumes.
  144.